home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / tcp / TCPHelp112NoLb.lha / Docsv1.12 < prev    next >
Text File  |  1995-05-21  |  15KB  |  392 lines
  1.  
  2.                                        ####..............  .....   ............
  3.     #########                         ###.############# ..#####. .############..
  4.     #########                         ###.#  -######## .#######. .#  -##########.
  5.     #########                         ###.# -######## .##  -###. .# -############.
  6.    ###########                         ##.#-######## .## ####### .#-#############.
  7.    ###########                           .########## .# -####### .######...#######.
  8.    ###########    #####  ##### ####   ####....##### .##-#####... .######.  .######.
  9.   #############   ##################  #####  .##### .#######.    .######.  .#-####.
  10.   ###### ######   ################### #####  .##### .######.     .######...## ####.
  11.   ###### ######   ################### #####  .##### .######.     .#########- -###.
  12.  ####### #######  #####  #####  ##### #####  .##### .######.     .########- #####.
  13.  ######   ######  #####  #####  ##### #####  .##### .######.     .##############.
  14.  ######   ######  #####  #####  ##### #####  .##### .#######.    .############..
  15. ################# #####  #####  ##### #####  .##### .########... .######......
  16. ################# #####  #####  ##### #####  .###### .########## .######.
  17. ################# #####  #####  ##### #####  .###### .########## .######.
  18. ################# #####  #####  ##### #####  .######. .########. .######.
  19. ######     ###### #####  #####  ##### #####  .######.  .#######. .######.
  20. ######     ###### #####  #####  ##### #####  .######.   ..#####. .######.
  21.                                                ......      ......  ......
  22.  
  23.  
  24.  
  25.                                         #    #       #
  26.                                         #    #       #
  27.                                         #    #  ###  # # ##   ###  # ##
  28.                                         ###### #   # # ##  # #   # ##
  29.                                #####    #    # ##### # #   # ##### #       #####
  30.                                         #    # #     # #   # #     #
  31.                                         #    # #   # # ##  # #   # #
  32.                                         #    #  ###  # # ##   ###  #
  33.                                                        #
  34.                                                        #
  35.                          - Version 1.12 21.V.95 -
  36.                                By Ben Vost
  37.  
  38.  
  39.  
  40. This is just a little gizmo to work with the Demon AmiTCP
  41. installation. It possibly won't cope with any other AmiTCP setup but
  42. you can try. To start with it needs a script called "startnet" in
  43. Amitcp:bin/. You can set the tooltypes to reflect the programs you
  44. want to use for linking, ftp, mail, news, etc.
  45.    
  46. It was written using a mixture of CanDo 2.0 and 3.0 and requires the
  47. supplied cando.library (in libs:). Sorry about the *enormous* ASCII
  48. Art logo, but I just got Photogenics and I wanted to try it out. :)
  49.  
  50. Unfortunately, any errors in location or setup just result in the
  51. program not running at all, with no explanation for what went wrong.
  52. Make sure that you have Rexxc in your path, or copy the "RX" program
  53. from Rexxc into C:.
  54.  
  55.  
  56. Requirements
  57. ------------
  58.  
  59. As far as I know it should run on any Amiga with an AmiTCP
  60. installation (and possibly a Demon account :)). I have tested on an
  61. Amiga 3000 and 3000T running WB3.1 and also an A4000/040 running
  62. WB3.0. I don't think that there is a reason why it shouldn't run on
  63. an earlier operating system, but you do need ARexx. To use the
  64. GetNews button you must have the script "NNTPTransfer" in AmiTCP:bin.
  65. The provided nntptransfer script has a couple of alterations to the
  66. one provided by DIS, namely paths for all the commands and an
  67. automatic retry if News is busy (thanks Tez (Tez@tezboyes.demon.co.uk)).
  68.  
  69.  
  70. Installation
  71. ------------
  72.  
  73. This part's really tricky so pay attention.
  74.  
  75. Copy AmiTCPHelper anywhere you like. :)
  76.  
  77. (Seriously, do check that the tooltypes agree with your set up and
  78. that the supplied nntptransfer script is in AmiTCP:bin.)
  79.  
  80.  
  81. Buttons
  82. -------
  83.  
  84. The buttons do what they say they do. If you have entered NONE for
  85. some of the tooltypes then AmiTCPHelper disables that button.
  86.  
  87. The Mail button changed in version 1.07 to account for multiple
  88. mailboxes. The problem with the unfriendly mailboxes has been sorted
  89. out in version 1.11 (thanks to Ben Scott) and now the mailbox names
  90. are presented in the requester's button as they should be.
  91.  
  92. Ping, Finger, Clock & now Telnet
  93. --------------------------------
  94.  
  95. Just type in the name of whoever you want to ping or finger and hit
  96. return. Clock works the same way and will save the resulting time.
  97. AmiTCPHelper will pop up a window with the relevant details. I have
  98. finally added Telnet to AmiTCPHelper, it's not that it was difficult
  99. to do, it's just that I never use it, so I didn't put it in. But then
  100. again, I hardly ever use Gopher, but I put that in, so there you go
  101. :þ
  102.  
  103. Telnet works the same way that all the other field-based tools in
  104. AmiTCPHelper do, just type in where you want to go. You can include
  105. the port name as well.
  106.  
  107.  
  108. Newsgroups
  109. ----------
  110.  
  111. This window will list any newsgroup configs you have. You can
  112. double-click on an entry to make it the current "NewsGroups" file.
  113. Newsgroup files should be named "newsgroups.what_you_like" and put in
  114. where newsroups normally go, your Amitcp:usr/lib directory. This is
  115. where AmiTCPHelper will look for them. Your original newsgroups file
  116. is copied to AmiTCP: and then copied back to AmiTCP:usr/libs when you
  117. quit AmiTCPHelper. You might want to make a newsgroups.std list
  118. containing your standard config in case AmiTCPHelper accidentally
  119. overwrites your original newsgroups because your machine has crashed
  120. or something. As of version 1.11 AmiTCPHelper no longer copies your
  121. newsgroups file to and fro. It was slowing down the start time of the
  122. program and it didn't serve any really useful function.
  123.  
  124.  
  125.  
  126.  
  127. Tooltypes and their meanings:
  128. -----------------------------
  129.  
  130. If you enter NONE for the tooltypes for FTP, Mail, Gopher, WWW, IRC or
  131. HList, then AmiTCPHelper will disable the appropriate button. (HList
  132. doesn't have a button but it won't be looked for when a web browser
  133. is loaded.)
  134.  
  135. WindowX        Gives the final x position of the AmiTCP helper on
  136.         the screen.
  137.  
  138. WindowY        Gives the final y position of the AmiTCP helper on
  139.         the screen.
  140.  
  141. DONOTWAIT    Standard commodity stuff if you want AmiTCPHelper in
  142.         your WBStartup drawer.
  143.  
  144. FTP        Put the path and name of your favourite FTP tool here.
  145.         Possibilities would include "AmiTCP:bin/mftp" or
  146.         "Comms:AmiTCP/ftp", etc. (No quotes are needed). I
  147.         have tested it with both of these and ncftp.
  148.  
  149. Mail        As for FTP. It has been tested with Elm. It doesn't
  150.         work with Mail since v1.07, but I forgot to change
  151.         the docs to reflect this, so sue me :)
  152.  
  153. WWW        As for FTP. Well, it's been tested with AMosaic, but
  154.         if there is a secret Netscape clone for the Amiga
  155.         that I could test it with, will someone PLEASE let me
  156.         know? :)
  157.  
  158. Gopher        As for FTP. Tested with Graham's AmigaGuide-based
  159.         Gopher.
  160.  
  161. News        This isn't currently working and will be removed
  162.         from v1.11 onwards until someone writes a newreader I
  163.         can call up with it.
  164.  
  165. AmiTCPhome    This is the home directory for AmiTCP. Make sure you
  166.         include    trailing "/" or ":", ie. "Data:AmiTCP/".
  167.  
  168. Editor        This is the editor you will run when editing your
  169.         config in the menus. Put the complete path and name
  170.         of the program. To be able to edit the files it says
  171.         it can they have to be in the AmiTCP:db and
  172.         AmiTCP:usr/lib directories. Tested with TurboText.
  173.  
  174. SMail        This is the sendmail command for AmiTCPHelper to use.
  175.         It must    reside in Amitcp:bin. Just enter the filename.
  176.  
  177. Link        This is your *ARexx* link script. AmiTCPHelper
  178.         automatically looks for this script in your
  179.         AmiTCPHome bin directory. Tested with "Link" and
  180.         phil's (phil@curve.demon.co.uk) "PLink".
  181.  
  182. LinkOpts    The options for linking up. You should at least give
  183.         "up" as an option, but you can also put "up news" or
  184.         any other commands that your link script supports.
  185.  
  186. HList        As for FTP. This is the Hotlist program for Mosaic.
  187.         There is only one as far as I know.
  188.  
  189. Ping        As for FTP. This is your Ping command.
  190.  
  191. Finger        As for FTP. This is the command you should use for
  192.         finger (oo-err).
  193.  
  194. Clock        As for FTP. This is the clock command you are going
  195.         to use. So far I have only tested it with Syncro.
  196.  
  197. IRC        As for FTP. Enter the name of your IRC client.
  198.         Remember to include the path. Tested with Grapevine.
  199.  
  200. Telnet        Your telnet application. It works with Telnet_VGOODER
  201.         from Demon and should work with most if not all of
  202.         the others.
  203.  
  204. Startnet    This tooltype determines whether you want the
  205.         startnet script executed by AmiTCPHelper or in your
  206.         user-startup. Enter yes for yes and no for no (quel
  207.         surprise!).
  208.  
  209. WinSize        WinSize sets the size for the output window that
  210.         AmiTCPHelper produces. It should consist of four
  211.         numbers separated by /. For instance:- 0/0/400/200.
  212.         This will open the window in the top left hand corner
  213.         of the screen which will be 400 pixels wide and 200
  214.         pixels high.
  215.  
  216. Menus:
  217. ------
  218.  
  219. Project Menu
  220.  
  221. About        This shows you what version of AmiTCPHelper you are
  222.         running and my name and email address. If you
  223.         register this is where your personalisation will
  224.         appear.
  225.  
  226. About CanDo    This gives some information about CanDo v3.
  227.  
  228. Quit        Surprisingly enough, this actually quits out of
  229.         AmiTCPHelper.
  230.  
  231.  
  232.  
  233. Edit Menu
  234.  
  235. Aliases        Hmm, God knows what this does...
  236.  
  237. Config        This lets you edit your AmiTCP:usr/lib/config file.
  238.         I'm not really sure if this is any use at all...
  239.  
  240. DialScript    Lets you edit that dialscript...
  241.  
  242.  
  243. NewsGroups    Surprise, surpise, surprise... This lets you edit your
  244.         newsgroups. Remember kiddies, the number after the
  245.         newsgroup is how many days to keep news for before it
  246.         gets trimmed.
  247.  
  248. NewsStamp    Lets you edit the newsstamp so you aren't on the
  249.         blower downloading all night... :)
  250.  
  251. Startnet    Lets you edit the startnet script. Changes made will
  252.         obviously not work until you re-run the startnet
  253.         script.
  254.  
  255. .signature    Duh, not sure really...
  256.  
  257.  
  258. To Do List:
  259. -----------
  260.  
  261. Sort out the default directory for downloading.
  262.  
  263. Amigaguide documentation. (Like it really needs it! :) )
  264.  
  265. Sort out the Prefs page. As of version 1.12 I've dumped this idea.
  266.  
  267. Add a newsgroups editor that grabs the new newsgroups list from
  268. nntptransfer, and also lets you browse an "active" list. Done! It's a
  269. separate program called GroupEditor, downloadable from an Aminet site
  270. near you (comm/tcp).
  271.  
  272. Not sure of anything else, really. Any suggestions?
  273.  
  274.  
  275. Legal Stuff:
  276. ------------
  277.  
  278.  
  279. Disclaimer
  280. ==========
  281.  
  282.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  283. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  284. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
  285. WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  286. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  287. A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
  288. PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  289. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
  290. CORRECTION.
  291.  
  292.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  293. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  294. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  295. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  296. DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
  297. (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  298. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE
  299. OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
  300. HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  301. DAMAGES.
  302.  
  303.  
  304. AmiTCPHelper is not Public Domain and is © Ben Vost 1995. If you
  305. register with me for £10, I will ensure that you receive all
  306. upgrades, until further notice, via EMail automatically. I can also
  307. configure AmiTCPHelper to your tastes, changing the Ping, Finger,
  308. Telnet and Clock default addresses, things like that. I can also
  309. reinstate the much nicer eight-colour buttons. If you do not have an
  310. EMail facility, I'm not sure what I will do (and why are you using my
  311. program?!), but contact me at the following address:
  312.  
  313. EMail:    Ben@subway.demon.co.uk
  314.  
  315. SMail:  Ben Vost
  316.     124 Bank Street
  317.     Macclesfield
  318.     Cheshire SK11 7AR
  319.  
  320. Tel:     01625 730741
  321.  
  322. History
  323. -------
  324.  
  325. v1.12    Yet another rejig of the buttons as the Prefs and Read News
  326.     buttons have been removed. Not sure if I like the new layout
  327.     so it might get changed yet again...
  328.     I've added a DOSNotify event to check to see if a new mailbox
  329.     has been added when mail is received. Previously, the only
  330.     time AmiTCPHelper checked for the names of the mailboxes was
  331.     at startup.
  332.     One internal change with regard to how registered owners are
  333.     dealt with...
  334.     Dumped the Prefs page as being beyond my capabilities and
  335.     also a bit pointless.
  336.  
  337. v1.11    Changed the nasty mailbox requester to something a bit more
  338.     standard.
  339.     Removed the Newsgroups backup option at startup.
  340.     Added a tooltype to allow AmiTCPHelper's output window to be
  341.     sized and positioned where desired.
  342.     
  343. v1.10    Added Telnet support (for completeness sake).
  344.     Added a new eight-colour (and four-colour) icon that freely
  345.     plagiarises the Xen style :)
  346.     More internal wrangling going on for the prefs page which
  347.     should be complete soon (maybe v1.12).
  348.     Added Startnet tooltype.
  349.  
  350. v1.09    Added startnet script editing in the Edit menu.
  351.     Added IRC and Prefs buttons to the interface which has been
  352.     jiggled to fit the new buttons in without requiring more
  353.     space. The Prefs button doesn't work at the mo, but will
  354.     eventually let you edit TCP-related ENV variables and the
  355.     co-ordinates and size of the windows that AmiTCPHelper opens
  356.     amongst other things.
  357.  
  358. v1.08    The Get News button now works! Hurrah!
  359.  
  360. v1.07    Changes made to the way Mail is dealt implemented in this
  361.     version.
  362.  
  363. v1.06    General tidying up.
  364.     Internal changes to the way mail is dealt with.
  365.  
  366.  
  367. v1.051    Changed the buttons to four colour ones for the Amiga
  368.     Computing Cover disk.
  369.  
  370. v1.05    Made Mail detach when run from AmiTCPHelper.
  371.     Added the Clock function.
  372.     Took out the sound samples, they were taking up far too much
  373.     space. If anyone wants them back, I can put them in just for
  374.     you.
  375.     Changed the About message and added the CanDo about.
  376.     Fiddled about with Get News, it's still not quite ready, but
  377.     hopefully the next release should see that button enabled.
  378.     (No promises... :) )
  379.  
  380. v1.04    Added support for multiple newsgroups.
  381.  
  382. v1.03    Changed the shape of the window to make it easier to use Ping
  383.     and Finger.
  384.     Miscellaneous internal tidying up.
  385.  
  386. v1.02    Added support for Ping and Finger.
  387.  
  388. v1.01     Added support for user definable link command and options.
  389.     Added better support for AMHotlist.
  390.     Added Info menu item.
  391.  
  392. v1.0     First public release